home *** CD-ROM | disk | FTP | other *** search
/ Chip 1998 September / CHIP NET Rehberi Eylül 1998.iso / ftp / ezftch15 / Usage.txt < prev   
Text File  |  1998-03-21  |  8KB  |  160 lines
  1. ================================================================
  2.          Important usage notes for EasyFetcher 1.5b
  3. ================================================================
  4.  
  5.   For simple use, just type in the document's URL (together
  6. with its protocol specification - ftp:// or http://), and hit
  7. Enter. Note that "document" can refer to any file that exists
  8. on the server, including HTML (Web) files. Here are examples
  9. of the simple usage (all URLs are fictional):
  10.   http://www.zipware.com/windows/32bit/utils/bla-bla.zip
  11.   ftp://ftp.gamehaven.com/pub/win2000/games/ripper.exe
  12. If you specify an empty path on a Web server (you can't use
  13. an empty path for FTP), EasyFetcher will retrieve the default
  14. document for that directory (usually "index.html" or 
  15. "default.htm"). For example, "http://www.zdnet.com/" will get
  16. you the default HTML document for www.zdnet.com (without the
  17. inline graphics, Java applets, and other external files, 
  18. of course); and "www.hotshots.com/LookeeHere/" will return
  19. the default document for the "/LookeeHere" directory at
  20. www.hotshots.com. Just be sure to add the trailing slash
  21. to the name of the directory, otherwise EasyFetcher will
  22. look for a document named "LookeeHere" in the root directory
  23. of the server, which doesn't exist.
  24.  
  25. ============================================================
  26.                ----  Protocols  ----
  27.  Only the HTTP and FTP protocols are supported.
  28. If the server's name starts with "www" (e.g. www.byte.com),
  29. or the protocol is explicitly specified as http://, EasyFetcher
  30. communicates with the server using HTTP. Otherwise, if no 
  31. protocol is specified (and server's name doesn't start with
  32. "www"), FTP is assumed. So if you need to get a file from an
  33. FTP server that happens to use "www" as the first three letters
  34. of its name, be sure to include ftp:// before its name.
  35. Numerical server addresses are also accepted ("198.56.28.101").
  36. HTTP URLs can use redirection, for example:
  37.   http://www.booknet.com/cgi-bin/hotbooks/info.pl?code=000Z8N
  38.  
  39. ============================================================
  40.           ----  Usernames and passwords  ----
  41.  Usernames and passwords can be used with FTP servers. They
  42. have to be included in the URL in the following form:
  43.   ftp://your_username:your_password@servername.com
  44. That is, username followed by colon (:), password, the at sign
  45. (@), and the rest of the path, including server, directories,
  46. and the file. For example, if you have a username "Jackie"
  47. with the password "TakeAguess" on the "ftp.fileserver.edu" 
  48. server, and you need a file that is only accessible through
  49. that username, URL will look like this (ftp:// is optional):
  50.   Jackie:TakeAguess@ftp.fileserver.edu/Jackie/Stuff/dolls.zip
  51. Note that you cannot specify a password without supplying a
  52. username, but you can supply a username without a password
  53. (in the form "username@servername.com"), in which case the
  54. default will be used. The defaults are:
  55.   username: anonymous
  56.   password: guest@somewhere.com
  57.  
  58. ============================================================
  59.                   ----  Ports  ----
  60.  You can specify a port to be used to connect to server.
  61. The port has to be supplied after the server name (separated
  62. by a colon ":") and before the path, like this (port 85):
  63.   http://www.hitme.com:85/software/Internet/zipper.zip
  64. Keep in mind that supplying a port doesn't change the
  65. specified (or assumed, if none specified) protocol.
  66.  
  67. To sum up, here are all the elements of a URL:
  68.    http://users_name:mypassword@www.server.com:16080/directories/file.ext
  69. ^protocol^^username^ ^password^ ^server name ^ port ^-- path --^ ^ file ^
  70.  
  71. ============================================================
  72.            ----  Command-line arguments  ----
  73.  EasyFetcher can be used with command-line options.
  74. Here are the available switches:
  75.  -s:<complete URL of the source file>
  76.  -d:<destination file>
  77.  -q  (quiet option)
  78.  -l:<log file for status information>
  79.  -o  (open the file after download)
  80. All switches can be upper or lower case and in any order.
  81. Do not use quotes in any of the options. The URL after the
  82. -s: switch designates the exact same URL you would enter 
  83. in EasyFetcher's interactive mode, so the entire discussion
  84. above (including usernames, passwords and ports) applies to
  85. command-line mode also. This is the only required switch for
  86. command-line mode. If no destination file (-d:) is specified,
  87. the file will be saved in EasyFetcher's program folder with
  88. the same name as in the URL. For example, if you invoke the
  89. program like this:
  90.   ezfetch -s:http://www.sounds.com/download/sizzle.zip
  91. the file "sizzle.zip" will be saved in the folder where
  92. you placed EasyFetcher's program files. Note that you will
  93. not be prompted for a filename.
  94. The filename after the -d: option can refer to a file on
  95. a remote computer on your network.
  96. For example, you can run the above command like this:
  97.   ezfetch -s:http://www.sounds.com/download/sizzle.zip
  98.           -d:\\bill\ddrive\apps\sizzle.zip
  99. or like this (if the drive is mapped to K:):
  100.   ezfetch -s:http://www.sounds.com/download/sizzle.zip
  101.           -d:k:\apps\sizzle.zip
  102. In command-line mode, if a file already exists by that name
  103. in destination folder, it will be overwritten without warning.
  104. It's up to you to make sure the name is unique.
  105. If the "quiet" option (-q) is specified, EasyFetcher's window
  106. will not appear and there will be no user interaction, even
  107. when errors occur. (In unregistered version, you will still
  108. get shareware messages, even in "quiet" mode.) To have greater
  109. control over the transfer you can specify a log file (-l:) 
  110. with the "quiet" option to keep track of the download. Note
  111. that the logfile is not available unless -q is also entered.
  112. Again, if the file already exists it will be overwritten,
  113. and if no path (drive and folders) is specified, the file will
  114. be saved in EasyFetcher's program folder.
  115. Specifying the -o switch will open the file after the transfer
  116. is complete (same as checking the 'Open the file after download'
  117. checkbox in interactive mode).
  118. Considering what was said, you are advised to provide the full
  119. paths both to your destination file and to the log file after
  120. making sure the files don't already exist. Here's an example:
  121.   ezfetch -s:ftp.cdrom.com/pub/windows95/index.txt
  122.    -d:c:\download\cdrom-index.txt -q -l:c:\download\cdrom.log
  123. which means: connect to the FTP server "ftp.cdrom.com", fetch
  124. the file "index.txt" located in "/pub/windows95", save it on
  125. my C: drive in "download" folder by the name "cdrom-index.txt"
  126. while doing it all silently and logging the results to file
  127. "cdrom.log" in the same folder.
  128.  
  129. ============================================================
  130.              ----  Miscellaneous  ----
  131.  Checking the 'Open the file after download' checkbox at
  132. any time before the download is complete will open the
  133. file (after the transfer is finished) in its associated
  134. application. For example, if you have WinZip installed
  135. on your machine and you downloaded a ZIP file, it will
  136. be opened in WinZip. Executable files (with the .EXE,
  137. .BAT, .COM extensions) will be simply executed. "Opening"
  138. executables automatically is strongly NOT recommended,
  139. unless you are absolutely sure of the file's origin
  140. and purpose.
  141.  Estimated time left that is displayed while the file is
  142. being downloaded is based on the size of the file and
  143. the current transfer rate. If the size could not be 
  144. determined, this statistic is not available.
  145.  If you get a message saying that a directory or a file does
  146. not exist on the server, make sure you use the correct case
  147. of letters in their names. Unix servers are case-sensitive.
  148.  Web sites requiring authenticated login, Secure HTTP
  149. (https://), or SSL encryption are not supported.
  150.  Finally, there is a great variety of servers on the Net.
  151. Some of them are short and to-the-point in their replies,
  152. and some are talkative. Although EasyFetcher was tested 
  153. with many types of servers and under different conditions,
  154. there is still a chance of an error when logging into a
  155. server (this can also happen due to the server being taken
  156. down for maintenance). If you experience this, you should
  157. always retry, either immediately, or a little later.
  158.  And when nothing seems to work, try restarting your
  159. Internet connection and EasyFetcher.
  160.